Oxoscript se transforme en NanoPy - plus d'infos

Fonctions audio

setBPM

  setBPM(bpm:int)

Définit le BPM (beats per minute) des notes suivantes. La valeur par défaut est 120.

setBPM(240)
note(C_NOTE_C, C_DURATION_1_2)
delay(1000)
setBPM(120)
note(C_NOTE_C, C_DURATION_1_2)
delay(1000)

setOctave

  setOctave(octave:byte)

Définit l’octave des notes suivantes.

setOctave(C_OCTAVE_C5)
note(C_NOTE_E, C_DURATION_1_4)
delay(500)
setOctave(C_OCTAVE_C6)
note(C_NOTE_E, C_DURATION_1_4)
delay(500)

Octaves disponibles:

C_OCTAVE_C3
C_OCTAVE_C4
C_OCTAVE_C5
C_OCTAVE_C6
C_OCTAVE_C7
C_OCTAVE_C8

setWaveform

  setWaveform(waveform:byte)

Définit la forme d’onde des sons suivants. La valeur par défaut est le sinus (C_WAVEFORM_SINE).

setWaveform(C_WAVEFORM_SAWTOOTH)

Formes d’onde disponibles:

C_WAVEFORM_SQUARE
C_WAVEFORM_SAWTOOTH
C_WAVEFORM_TRIANGLE
C_WAVEFORM_SINE
C_WAVEFORM_RANDOM

soundEffect

  soundEffect(soundid:int)

Expérimental

Joue un son interne avec le soundid. Il est possible d’indiquer soit un numéro entre 0 et 4, soit l’une des constantes suivantes:

SOUND_STARTUP
SOUND_BLUB
SOUND_CRASH
SOUND_LEVEL
SOUND_LOSE

stopSong

  stopSong()

Arrête un morceau en cours de lecture. Aucun effet si aucune chanson n’est en cours de lecture.

playSong(true)
delay(1000)
stopSong()

resumeSong

  resumeSong()

Reprend un morceau en pause. Aucun effet si aucun morceau n’a été mis en pause.

playSong(true)
delay(1000)
pauseSong()
delay(1000)
resumeSong()

pauseSong

  pauseSong()

Met en pause un morceau en cours de lecture. Aucun effet si aucune chanson n’est en cours de lecture.

Une chanson en pause peut être reprise avec resumeSong() ou playSong(…).

playSong(true)
delay(1000)
pauseSong()

playSong

  playSong(autorepeat:bool)

Lit la chanson précédemment créée. Si la répétition automatique est définie, la chanson est lue indéfiniment.

beginSong()
note(C_NOTE_A, C_DURATION_1_4)
note(C_NOTE_B, C_DURATION_1_4)
note(C_NOTE_C, C_DURATION_1_2)
endSong()
playSong(false) # autorepeat = false
delay(2000)
playSong(true) # autorepeat = true

endSong

  endSong()

Termine le morceau. Toutes les fonctions tone() et note() après celle-ci sont jouées et ne sont plus stockées en tant que chanson.

beginSong()
note(C_NOTE_A, C_DURATION_1_4)
note(C_NOTE_B, C_DURATION_1_4)
note(C_NOTE_C, C_DURATION_1_2)
endSong()
playSong(false)

noteAdvanced

  noteAdvanced(note:byte, durFactor:float, octave:byte, articulation:float)

Joue une note pour le facteur de durée de tonalité, l’octave et l’articulation donnés.

noteAdvanced(C_NOTE_A, C_DURATION_1_4, C_OCTAVE_C5, C_ARTICULATION_STACCATO)

Notes disponibles:

C_NOTE_REST # 0 Hz
C_NOTE_C # 131 Hz
C_NOTE_CS # 139 Hz
C_NOTE_D # 147 Hz
C_NOTE_DS # 156 Hz
C_NOTE_E # 165 Hz
C_NOTE_F # 175 Hz
C_NOTE_FS # 185 Hz
C_NOTE_G # 196 Hz
C_NOTE_GS # 208 Hz
C_NOTE_A # 220 Hz
C_NOTE_AS # 233 Hz
C_NOTE_B # 247 Hz

Facteurs de durée de tonalité disponibles:

C_DURATION_1_1 # 4.0
C_DURATION_1_2 # 2.0
C_DURATION_1_4 # 1.0
C_DURATION_1_8 # 0.5
C_DURATION_1_16 # 0.25
C_DURATION_1_32 # 0.125

Octaves disponibles:

C_OCTAVE_C3
C_OCTAVE_C4
C_OCTAVE_C5
C_OCTAVE_C6
C_OCTAVE_C7
C_OCTAVE_C8

Articulations disponibles:

C_ARTICULATION_STANDARD
C_ARTICULATION_STACCATO
C_ARTICULATION_STACCATISSIMO
C_ARTICULATION_TENUTO
C_ARTICULATION_MARCATO
C_ARTICULATION_LEGATO

note

  note(note:byte, durFactor:long)

Joue une note pour le facteur de durée de tonalité donné.

note(C_NOTE_A, C_DURATION_1_4)

Notes disponibles:

C_NOTE_REST # 0 Hz
C_NOTE_C # 131 Hz
C_NOTE_CS # 139 Hz
C_NOTE_D # 147 Hz
C_NOTE_DS # 156 Hz
C_NOTE_E # 165 Hz
C_NOTE_F # 175 Hz
C_NOTE_FS # 185 Hz
C_NOTE_G # 196 Hz
C_NOTE_GS # 208 Hz
C_NOTE_A # 220 Hz
C_NOTE_AS # 233 Hz
C_NOTE_B # 247 Hz

Facteurs de durée de tonalité disponibles:

C_DURATION_1_1 # 4.0
C_DURATION_1_2 # 2.0
C_DURATION_1_4 # 1.0
C_DURATION_1_8 # 0.5
C_DURATION_1_16 # 0.25
C_DURATION_1_32 # 0.125

beginSong

  beginSong()

Configure un nouveau morceau. Toutes les fonctions tone() et note() après cela ne sont pas jouées mais stockées comme un morceau.

beginSong()
note(C_NOTE_A, C_DURATION_1_4)
note(C_NOTE_B, C_DURATION_1_4)
note(C_NOTE_C, C_DURATION_1_2)
endSong()
playSong(false)

noTone

  noTone()

Désactive la sortie audio.

tone(440, 0)
delay(1000)
noTone()

tone

  tone(frequency:int,duration:long)

Joue un son avec la fréquence “frequency” et la durée “duration” en millisecondes.

tone(440,1000)